Skip to content

docs: 补充-clear 写法与 -concat 提示#78

Open
Yunease wants to merge 1 commit intoOpenWebGAL:mainfrom
Yunease:patch-1
Open

docs: 补充-clear 写法与 -concat 提示#78
Yunease wants to merge 1 commit intoOpenWebGAL:mainfrom
Yunease:patch-1

Conversation

@Yunease
Copy link

@Yunease Yunease commented Feb 8, 2026

在 src/script-reference/commands/say.md 中进行了两处优化:
1.增加了-clear 的另一种写法,补充了注释。
2.为 -concat 写了新的tip,告诉用户无法通过applyStyle修改部分文本的颜色。

增加了-clear 的另一种写法
为 -concat 写了新的tip,告诉用户无法通过applyStyle修改特定文本的颜色。
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @Yunease, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

此拉取请求优化了 src/script-reference/commands/say.md 文件中的文档内容。它澄清了 -concat 参数在文本样式方面的限制,并为 -clear 参数提供了额外的用法示例和解释,从而提高了命令参考的清晰度和完整性。

Highlights

  • 优化 -concat 提示: 增加了关于 -concat 命令的新提示,解释了 applyStyle 无法用于修改部分文本颜色的限制,并说明了样式更新会导致文本重播的原因。
  • 补充 -clear 用法: 补充了 -clear 命令的另一种写法 (-clear=true),并明确了当 -clear 没有值时,默认会关闭说话者栏。

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • src/script-reference/commands/say.md
    • 增加了关于 -concat 命令的提示,解释了 applyStyle 无法用于修改部分文本颜色的限制。
    • 补充了 -clear 命令的用法示例,包括 -clear=true 的写法,并说明了无值时的默认行为。
Activity
  • 目前没有与此拉取请求相关的评论或审查活动。
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

感谢您对文档的贡献!您为 -concat 添加的提示和对 -clear 用法的补充都很有帮助。我针对这两处修改提出了一些微调建议,旨在使文档表达更清晰、更准确,希望能对您有所帮助。

Comment on lines +45 to +47
::: tip
如果在拼接文本前使用了 applyStyle 修改文本框文本的样式,如让文字变色,由于 outer 与 inner 作用于整个文本框的文本,因此无法通过这种方式单独更改个别文本的颜色,反而会因为样式的更新导致完整的拼接文本会重新播放一遍。
:::
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

这部分提示信息写得很好,清晰地指出了 applyStyle-concat 同时使用时可能遇到的问题。
为了让它更易于理解,可以考虑稍作简化和调整。当前的句子较长,并且提到了 outerinner,这可能对不熟悉内部实现的用户造成困惑。
建议修改为更直接的描述,强调 applyStyle 作用于整个文本框,并说明可能导致的后果。

Suggested change
::: tip
如果在拼接文本前使用了 applyStyle 修改文本框文本的样式,如让文字变色,由于 outer 与 inner 作用于整个文本框的文本,因此无法通过这种方式单独更改个别文本的颜色,反而会因为样式的更新导致完整的拼接文本会重新播放一遍
:::
::: tip
请注意,`applyStyle` 会作用于整个文本框。因此,在拼接文本 (`-concat`) 时,无法通过 `applyStyle` 单独更改部分文本的颜色。这样做反而可能因样式更新,导致已拼接的文本重新播放
:::

```webgal
say:这是一句话。 -speaker=角色A;
say:这是一个旁白。 -clear;
say:这是一个旁白。 -clear; 没有值的情况默认关闭说话者栏
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

这里的注释“没有值的情况默认关闭说话者栏”中的“默认”一词可能稍有歧义。-clear 是一个布尔标志,它的出现即代表值为 true,并非一种“默认”行为。为了更精确地描述这种简写形式,建议将注释修改得更简洁、准确。

Suggested change
say:这是一个旁白。 -clear; 没有值的情况默认关闭说话者栏
say:这是一个旁白。 -clear; ; 等同于 -clear=true

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant